home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / pcboard / scall121.zip / SAMCALL.DOC < prev    next >
Text File  |  1994-05-29  |  13KB  |  264 lines
  1. ───────────────────────────────────────────────────────────────────────────────
  2.  
  3. Program:       SAMCALL v1.21 - Compiled on May 29,1994 - Copyright 1993-1994
  4.  
  5.                ───────────
  6.  
  7. Warranty:      This product is provided "as is" without warranty of any kind.
  8.                The entire risk as to the results and performance of the
  9.                program is assumed by you.  Furthermore, the author does not
  10.                warrant, guarantee, or make any other representations regarding
  11.                the use of, or the results of the use of the program,  and you
  12.                rely on the program and results solely at your own risk.  The
  13.                author cannot and will not accept responsibility for system
  14.                damage, loss of profit, or any other special, consequential or
  15.                incidental damages resulting from the use or inability to use
  16.                this product.
  17.  
  18.                ───────────
  19.  
  20. Copyright:     SAMCALL, Copyright (c) 1993-94 by Bill Shryock - WD0GRC, is
  21.                being distributed as Shareware.  Under this concept you may
  22.                use the SHAREWARE (unregistered) version for a reasonable
  23.                period of time for evaluation after which you must either
  24.                register your copy or discontinue usage.
  25.  
  26.                ───────────
  27.  
  28. Distribution:  You are encouraged to distribute SamCall provided that all
  29.                files contained in the archive are distributed in their original
  30.                and unmodified state.
  31.  
  32.                ───────────
  33.  
  34. Description:   PPE (PCBoard Programming Executable) extension to PCBoard v15.x
  35.                that will provide callers access to the SAM Amateur Radio
  36.                Callsign Database.  SAMCALL.PPE supports both ANSI and Non-ANSI
  37.                terminals.  SamCall is distributed complete and fully
  38.                functional.  SAMCALL.PPE represents many hours of programming
  39.                and debugging and you are welcome to install SamCall on your BBS
  40.                and check it out for suitability to your requirements.  If you
  41.                continue to use SamCall then a $10.00 registration is required.
  42.                Thirty days should to be enough time to evaluate SamCall.  If
  43.                after thirty days you wish to continue using SamCall then please
  44.                fill out the enclosed "SAMCALL.REG" file and mail it with your
  45.                check to:
  46.  
  47.                      WD0GRC
  48.                      William M. Shryock, Jr.
  49.                      11323 Donnie Drive
  50.                      Mabelvale, AR  72103-3023
  51.  
  52.                Thank you.
  53.  
  54.                ───────────
  55.  
  56. Requirements:  It is assumed that you have installed the SAM Database.  If
  57.                not, then you will need to before SAMCALL.PPE will function.
  58.                Refer to the SAM installation guide for help installing the
  59.                SAM database.  The examples that follow assume the SAM Database
  60.                is installed on C: drive in the directory \SAM and that the API
  61.                Interface is in the directory \SAM\API.  These are the SAM
  62.                installation defaults.
  63.  
  64.                You will need to edit your AUTOEXEC.BAT file to allow access to
  65.                the SAM database.
  66.  
  67.                Add the following two lines:
  68.  
  69.                    CD \SAM\API
  70.                    SAMAPI C:\SAM
  71.  
  72.  
  73.                The SAM Amateur Radio Callsign Database is available from:
  74.  
  75.                    RT Systems, Inc.
  76.                    Box 8
  77.                    Lacey's Spring, AL  35754
  78.  
  79.                    1 (205) 882-9292
  80.  
  81.                Their 1994 price is $39.95 plus $5.00 S/H.  SamCall WILL
  82.                support the additional options offered by RT Systems at
  83.                $7.50 each.  Those options are: County, Full Date of Birth,
  84.                License Expiration Date, Previous Call and Year First Licensed.
  85.                Starting with SamCall version 1.20, that extra information will
  86.                be displayed if installed in your SAM files.
  87.  
  88.                There is no connection between myself and RT Systems, Inc. and
  89.                neither supports the other.  SAM and RT Systems, Inc. are
  90.                trademarks and/or copyrights of RT Systems, Inc.
  91.  
  92.                In addition to SamCall and the SAM files you will also need
  93.                PCBoard v15.0 or later and some type of ASCII text editor.
  94.  
  95.                ───────────
  96.  
  97. Installation:  Installation is very simple:  Install the SAM database on your
  98.                BBS computer.  UnZip these files to a directory of your choice.
  99.                Run PCBSETUP and edit your CMD.LST to install SAMCALL.
  100.  
  101.                From the PCBSETUP menu select:
  102.  
  103.                       B  File Locations
  104.  
  105.                           then
  106.  
  107.                       B  Configuration Files
  108.  
  109.                           then select
  110.  
  111.                       Name/Loc of Default CMD.LST File
  112.  
  113.                           and press "F2"
  114.  
  115.                       Fill in the requested information using the following
  116.                       example as a guide.
  117.  
  118.     EXAMPLE
  119.     -------
  120.                                   File Locations
  121.  
  122.            Command       Security  PPE/MNU File -or- Keystroke Replacement
  123.            ════════════  ════════  ═══════════════════════════════════════
  124.         1) SAMCALL            0    C:\PCB\PPE\SAMCALL\SAMCALL.PPE
  125.  
  126.  
  127.                SAMCALL.CFG will need to be edited with an ASCII Editor by you
  128.                to include your information.  The enclosed SAMCALL.CFG will
  129.                serve as an example.
  130.  
  131.                The first three lines of SAMCALL.CFG are for your BBS
  132.                information.  These lines will be colorized and centered if the
  133.                caller's terminal supports ANSI, otherwise they will be
  134.                displayed left justified and monochrome.
  135.  
  136.                Copy the file "SAMCALL" to your PCBoard HELP directory.  This is
  137.                the help file displayed to the caller if they request help for
  138.                SamCall.
  139.  
  140.                Edit your BRDM/BRDBG (Main Menu) file and add "SAMCALL" as a
  141.                command. ie: "SAMCALL Callsign Lookup"
  142.  
  143.                There are two files in the SamCall archive that you may want to
  144.                delete.  The first one is HAMCALL.PPE, if you are upgrading from
  145.                an older version, the name was HAMCALL.  Your callers will be in
  146.                the habit of typing HAMCALL to bring up the server.  The file
  147.                HAMCALL.PPE will remind them to type SAMCALL instead.  If you
  148.                choose to install the HAMCALL PPE then you will also need to
  149.                add it to the CMD.LST in PCBSETUP as above, along with the
  150.                SAMCALL.PPE.  This is optional and only indicated if you are
  151.                upgrading from Hamcall.  You may want to remove it after your
  152.                callers get use to the new name.
  153.  
  154.     EXAMPLE
  155.     -------
  156.                                   File Locations
  157.  
  158.            Command       Security  PPE/MNU File -or- Keystroke Replacement
  159.            ════════════  ════════  ═══════════════════════════════════════
  160.         1) SAMCALL            0    C:\PCB\PPE\SAMCALL\SAMCALL.PPE
  161.         2) HAMCALL            0    C:\PCB\PPE\SAMCALL\HAMCALL.PPE
  162.  
  163.  
  164.                The second file you may want to delete or edit if you choose to
  165.                use it, is NEWNAME.$$$.  This is an ASCII file that can be
  166.                displayed when the caller types HAMCALL by mistake.  The file as
  167.                is, is the very same data that HAMCALL.PPE will display if the
  168.                file NEWNAME.$$$ does not exist.  It is only provided to allow
  169.                you to change the text to be displayed, if you wish.  Removing
  170.                the file from the PPE directory will speed up the display
  171.                because SamCall doesn't have to read the file to display it.
  172.                The same text is hard coded into HAMCALL.PPE.  If you do not
  173.                install HAMCALL.PPE per the above instructions, then NEWNAME.$$$
  174.                will never be used and may be deleted.
  175.  
  176.                Now all that is left to do is check for proper operation and
  177.                leave a message to you users that you now have the SAM Callsign
  178.                data base on-line for their use.  Since I installed the SAM
  179.                data base on my BBS, it has seen a lot of activity and favorable
  180.                comments.  If you would like to see it in operation, just call
  181.                The Ether Net BBS at 501 455-0628.  After you log on type
  182.                SAMCALL at the Main Menu.  You can FREQ the latest version of
  183.                SAMCALL.PPE using the Magic Name "SAMCALL" or you can download
  184.                it while on-line.  Use the Zippy search for "SAMCALL".
  185.  
  186.                SAMCALL.PPE is running on a 2 node version of PCBoard with the
  187.                second node used for maintenance and local access using
  188.                Netware Lite v1.1.  To date, I have experienced no problem using
  189.                SamCall through the LAN.  The setup here is PCBoard 15.1, 2 Node
  190.                Version, Netware Lite v1.1 on a 386 DX40 with a Gigibyte drive
  191.                and many many TSR's installed.
  192.  
  193.                ───────────
  194.  
  195. Operation:     Operation is very simple.  From the BBS menu, type SamCall.  You
  196.                will be presented the following screen:
  197.  
  198.  
  199.                 SAM Amateur Radio Callsign Data Base, U.S. & Canadian
  200.                                           on
  201.                            The Ether Net Amateur Radio BBS
  202.  
  203.                      Copyright 1993-1994 by Bill Shryock, WD0GRC
  204.  
  205.          ╔═══════════════════════════════════════════════════════════════════╗
  206.          ║                                                                   ║
  207.          ║                                                                   ║
  208.          ║                                                                   ║
  209.          ║                                                                   ║
  210.          ║                                                                   ║
  211.          ║                                                                   ║
  212.          ║                                                                   ║
  213.          ╚═══════════════════════════════════════════════════════════════════╝
  214.                                                                 Version 1.21
  215.  
  216.                            Registered to: The Ether Net BBS
  217.  
  218.   (55 left) H)elp, Callsign, M)essage or ENTER = Quit ? (      )
  219.  
  220.                Enter the desired callsign and press enter.  To exit SamCall,
  221.                press ENTER alone.
  222.  
  223.                New with Version 1.20 of SamCall is the Message Command.  This
  224.                will allow users to save the data they have been viewing to a
  225.                message.  Entering a "M" at the callsign prompt will cause
  226.                SamCall to send them a private message to the main board
  227.                conference then exit back to PCBoard.  They can then capture
  228.                that message and have the data in ASCII format to do with as
  229.                they wish.
  230.  
  231.                ───────────
  232.  
  233. Notes:         Just a few notes that don't fit anywhere else.  Because of the
  234.                way that the SHELL command works within the PPE environment,
  235.                whenever SamCall shells out to look up a call, the local screen
  236.                is cleared.  The remote screen is not cleared so the caller does
  237.                not see this.  Once SamCall has the data, it will re-paint the
  238.                local screen and does not send the entire screen to the remote
  239.                computer.  You will therefor be able to see what the caller is
  240.                seeing except that your screen is cleared while SamCall looks up
  241.                the data.
  242.  
  243.                If you are using a multi-node setup then you should have your
  244.                temporary work directories setup for each node.  SamCall will
  245.                use these directories to keep the message information separate
  246.                for each node.
  247.  
  248.                If you have any comments, suggestions or problems with SamCall,
  249.                you can call The Ether Net BBS or send Netmail to 1:3821/7.
  250.  
  251.  
  252.                PCBoard is registered to Clark Development Co.
  253.                Netware Lite is registered to Novell, Inc.
  254.                SAM is registered to RT Systems, Inc.
  255.  
  256.                ───────────
  257.  
  258. Support:       The Ether Net, Amateur Radio BBS
  259.                Bill Shryock, WD0GRC  Sysop
  260.                501-445-0628 - U.S. Robotics 16.8 DS
  261.                Fido  1:3821/7
  262.  
  263. ───────────────────────────────────────────────────────────────────────────────
  264.